home *** CD-ROM | disk | FTP | other *** search
/ IBM InfoROM for OS/2 Beta 1995 January / IBM InfoROM for OS2 Beta 1-1995.ISO / testcert / mmedia / system / ap2 / readme.ap2 < prev   
Encoding:
Text File  |  1994-05-11  |  7.2 KB  |  179 lines
  1. AP2 - The easy way to test multimedia device drivers!
  2. ----------------------------------------------------------------
  3. AP2 is the abbreviation for Automatic P2string. It was developed to
  4. simplify the testing of OS/2 MMPM/2 device drivers. AP2 ships with 589
  5. test scripts that stress your audio and video device drivers. AP2 is a PM
  6. front end to P2string that will test the capabilities of your MMPM/2
  7. device driver and automatically test only the functions that your device
  8. driver supports. AP2 uses the MCI CAPABILITY command to determine the
  9. actual functions your device driver supports.  It uses this information to
  10. build a test suite to stress the functions your device driver supports.
  11. The names of the scripts and a brief description of each script is
  12. listed in a PM window. The test person then has the ability to select any
  13. combination of scripts they wish to execute and to press the "START TEST"
  14. button. Each script in the PM (Presentation Manager) window will then be
  15. updated with the results of the script - RUNNING, SUCCESS or FAILURE. The
  16. VIEW OUTPUT button can be pressed to view the specific information on
  17. script status that is in the output file. Press STOP to cancel testing or
  18. EXIT to end AP2.
  19.  
  20. You can also press F1 or HELP button anytime to get information about
  21. specific topics.
  22.  
  23. WHAT DOES IT TEST?
  24. ==================
  25.       AP2 tests include:
  26.  
  27.       * AMPMIX:
  28.             - Volume
  29.             - Balance
  30.             - Gain
  31.             - Pitch
  32.             - Treble
  33.             - Bass
  34.  
  35.       * WAVE AUDIO:
  36.             - Connector
  37.             - Cue
  38.             - Load
  39.             - Pause
  40.             - Play
  41.             - Record
  42.             - Save
  43.             - Resume
  44.             - Set
  45.             - Status
  46.             - Stop
  47.  
  48.       All formats, channels, bits per sample and sample per second
  49.       are tested in the wave audio scripts.
  50.  
  51.       * MIDI:
  52.             - Close
  53.             - Play
  54.             - Load
  55.             - Save
  56.             - Set
  57.             - Stop
  58.  
  59.       * CD AUDIO:
  60.             - Play
  61.             - Eject
  62.             - Lock the eject button
  63.             - Set Volume
  64.  
  65.       * CDXA:
  66.             - Play
  67.             - Eject
  68.             - Lock the eject button
  69.             - Set Volume
  70.  
  71.       * VIDEO:
  72.             - Play
  73.             - Record
  74.             - Save
  75.             - Load
  76.             - Speed
  77.             - Volume
  78.  
  79.       * SOUND QUALITY:
  80.             These are interactive tests which require the user's
  81.             response. These files contain an "I" in their file names.
  82.                   - Sound quality of all sounds shipped with MMPM/2.
  83.                   - Sound quality of all wave files in different formats.
  84.                   - Sound quality of recording.
  85.  
  86. HOW TO INSTALL AP2:
  87. ===================
  88.       * Using the INSTALL.EXE program found in the AP2 directory
  89.         (Usually found on a CD ROM)
  90.       * Select which directory to install AP2.  The drive must have
  91.         at least 4 Megabytes free to load and run AP2.
  92.  
  93.  
  94. *NOTE:  If the test system has a CD-ROM installed, place an Audio CD
  95.         into the CD ROM drive before starting AP2.  Be sure the CD ROM
  96.         is connected to the Audio Adapter and there is a Microphone and
  97.         speakers attached to the system.  Some Audio Adapters may use a
  98.         MONO or a STEREO Microphone, test both types of microphones on
  99.         the adapter.
  100.  
  101. HOW TO USE AP2:
  102. ==============
  103.       RUNNING:
  104.       - Double click on the AP2 ICON
  105.       OR
  106.       - Type AP2 at command line with or without one or more of the
  107.         following switches:
  108.  
  109.         /ALL      : select ALL tests.
  110.         /AMPMIX   : select AMPMIX tests.
  111.         /CD       : select CDDA tests.
  112.         /CDXA     : select CDXA tests.
  113.         /MIDI     : select MIDI tests.
  114.         /WAVE     : select WAVE tests.
  115.         /VIDEO    : select VIDEO tests.
  116.  
  117.         /BATCH    : this switch is used with one or more SELECT switches
  118.                     above to automatically run those selected tests.  It
  119.                     ignores all interactive tests in the selected section,
  120.                     and puts all failures in a file (AP2.OUT is the
  121.                     default file name.)  Also, all of the errors in
  122.                     the execution will be logged to the output file.  When
  123.                     testing is complete, AP2 will terminate. Capability
  124.                     testing will be performed unless the /NOTEST switch is
  125.                     specified.
  126.  
  127.         /TEST     : device driver's capability testing on startup.
  128.         /NOTEST   : NO device driver's capability testing on startup.
  129.  
  130.         /DATAPATH=pathname : specify the path of data files.  To set the
  131.                     data path to "C:\DATA" use the following switch:
  132.                     /DATAPATH=C:\DATA
  133.  
  134.         /OOUTFILE : specify output filename which keeps all failures. To
  135.                     set the Output file to "MYTEST.OUT" use the following
  136.                     switch: /OMYTEST.OUT
  137.  
  138.       TESTING:
  139.       - You can select one or more test cases by highlighting them one by
  140.         one, or select ALL button to run all test cases.
  141.       - Press START TEST button to start running the test cases you
  142.         selected. As each test case terminates, the result of the test is
  143.         displayed in the list box (SUCCESS or FAILURE) and the output file
  144.         is in filename with an extension of ".OUT".  The ".OUT" file can
  145.         help you determine what cause the failure of a specific test case.
  146.       - The STOP button allows interruption of testing.
  147.  
  148.       DEVICE CAPABILITIES:
  149.       - AP2 starts by testing the audio device driver's capabilities if
  150.         the option was checked or by using switch /TEST.  According to the
  151.         outcome of the device capability testing, only the supported test
  152.         cases will be displayed. The file CAPABLTY.TXT lists the outcome
  153.         of the device capability testing.
  154.         You can skip this test by unchecking the appropriate check box in
  155.         lower left corner in the main window and restarting AP2, or by
  156.         using the /NOTEST switch.  In that case, all test cases will be
  157.         listed regardless of whether the device supports their functions
  158.         or not.
  159.  
  160. TEST CASE OUTPUT:
  161.       - The P2String output files have the same name as the test cases,
  162.         but have the extension ".OUT".  They are located in the current
  163.         directory.  Subsequent execution of the same test case will
  164.         overwrite the old ".OUT" file.  You may want to look at the ".OUT"
  165.         file to determine what causes the failure of a specific test case.
  166.         You can delete unnecessary output files at any time.
  167.       - RECORD test cases will save files in a file called "DELETE.WAV".
  168.         This file will be overwritten by subsequent RECORD test cases, and
  169.         can be deleted at any time.
  170.         NOTE: Test cases that contains ERROR's are not necessarily failing.
  171.         Test cases with the text "FAILED" are not working correctly.
  172.  
  173. HELPFUL HINTS
  174.      - CDXA testing requires the X*.P2S scripts to be modified to
  175.        specify a valid path name.
  176.      - The CD streaming capability is unpredictable if a CD is not
  177.        installed at the time the device capabilities are checked.
  178.  
  179.